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PREFACE 



UPDATE provides a means of maintaining and up- 
dating source decks on libraries in compressed 
symbolic format under the following operating sys- 
tems and computer systems. 

e NOS 1.0 and NOS/BE 1. for the CONTROL 
DATA® CYBER 170 Series, CYBER 70 
Series /Models 72, 73, and 74, and 6000 
Series Computer Systems 

® SCOPE 2. 1 for the CONTROL DATA® 
CYBER 70 /Model 7 6 and 7600 Computer 
Systems 
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FEATURES 



Features of UPDATE include: 

^ • Creation of a program library from source 

decks. 

9 Copying of old program libraries from se- 
' quential to random format and vice versa. 

.^ ® Merging of two program library files. 

• Updating of source decks by inserting, 

deleting, and restoring cards according to 
sequence in the deck or according to correc- 
tion set. 

9 Ability to completely and permanently re- 
move correction sets from the program 
library. 

9 Generation of a compile file containing cor- 
rected output acceptable as input to other 
processing programs, such as compilers 
and assemblers* Contents of the comnile 
file and subdivision of the compile file into 
logical records and files is controlled 
through UPDATE directives. This file can 
be formatted as 80- or 90-column card 
images or can be in compressed form. 

9 Processing of directives, new text, and new 
source decks from a file other than the job 
INPUT file. 

9 Generation of a new, updated program 
library. 

9 Comprehensive list output noting any changes 
occurring during the run and status of the 
program library. 

9 Ability to change the directive card master 
e control character. 

9 Recognition of abbreviated forms of direc- 
tives and capability of turning off the search 
for the abbreviated forms to speed up pro- 
^ cessing. 

9 Ability to use full 64- character set, includ- 
ing the colon. 

9 Checksumming of program library. 
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DIRECTIVE FORMAT 
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master control 
character 



directive name 



separator 



P^ 



In column one. It is de- 
fined by UPDATE to be an 
asterisk but may be 
changed through use of the 
■'' parameter on the UP- 
DATE control statennent. 

Starts in column two; 
terminated by a comma or 
one or more blanks. Most 
directives have a full name 
and an abbreviated name. 
When the NOABBREV 
directive is in effect, 
UPDATE does not recog- 
nize the abbreviated forms 
of the directive names. 

Parameters are separated 
by any character other than 
A through Z, through 9, 
or + - =:^ / ( ) $ or =. A 
separator has a display 
code value of 55„ or greater. 
No embedded blanks are 
permitted. 

Paranneter. Depending on 
its requirements, a 
directive may have no 
parameters or a number of 
parameters. Numeric 
parameter fields are 
decimal. 
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CARD IDENTIFICATION 



The full form of a card identifier is: 



ident. seqnum 
ident 



seqnum 



1-9 character name of a 
correction set or deck, 

A period terminates the 
ident. 

Decimal ordinal (1 to 
262143) of the card within 
the correction set or deck. 
Any character other than 
0-9 terminates the sequence 
number. 



The shortened forms of card identifiers can be used 
on BEFORE, INSERT, DELETE, RESTORE, and 
COPY directives. Shortened forms are expanded as 
follows : 



seqnum 



. seqnum 



Expands to idname. seqnum 
where idname is a correc- 
tion set identifier whether 
or not it is also a deck 
name. 

Expands to dname. seqnum 
where dname is a deck 
name. 



To specify an operation which affects all decks in a 
program library between and including two specified 
decks, the following format can be used. 

''-directive deck-j^. deckj^ 

This type of operation is allowed with PURDECK, 
SEQUENCE, and COMPILE 



60450000 A 



DIRECTIVE TYPES 

DECK IDENTIFYING DIRECTIVES 

DECK (DK) Identifies normal deck 

COMDECK (CD) Identifies common deck 

The following directives can be used prior to the 
first DECK or COMDECK directive in either a crea- 
tive run or a correction run. 



ABBREV 
DECLARE 

LIMIT 
LIST 



NOABBREV 

NOLIST 

READ 

REWIND 

SKIP 





If any directive other than one or more of the above 
precedes a DECK or COMDECK directive, the run is 
considered a correction run. 

CORRECTION DIRECTIVES 



Insert text after specified card 

Insert text before specified card 

Deactivate card and optionally 
insert text in its place 

Reactivate card and optionally 
insert text after it 

Copy and insert text from speci- 
fied deck 

Deactivate correction sets 

Selectively deactivate correc- 
tion sets 



YANKDECK (YD) Deactivate all cards in decks 



INSERT 


(I) 


BEFORE 


(B) 


DELETE 


(D) 


RESTORE 


(R) 


COPY 


(C) 


YANK 


(Y) 


SELYANK 


(SY) 
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PURGE 


(P) 


SELPURGE 


(SP) 


PURDECK 


(PD) 


CHANGE 


(CH) 


SEQUENCE 


(S) 



Permantly remove 
correction sets 

Permanently remove cards 
belonging to correction sets 
from specific decks 

Permanently rennove all 
cards in decks 

Change correction set 
name 

Resequence decks and 
purge all inactive cards 



FILE Av\AN!PULAT!ON DIRECTIVES 

File manipulation directives are illegal when UP- 
DATE is reading from an alternate file. They can 
be on the primary input file only. 



READ 

SKIP 

REWIND 



(RD) Read input stream from 
specified file 

(SK) Skip forward specified 

number of records on file 

(RW) Rewind named file 



These operations cannot be performed on the follow- 
ing reserved files or their equivalents: 



INPUT 

OUTPUT 

COMPILE 

SOURCE 

OLD PL 

NEWPL 

MERGE 



Source of directives and 
input text 

List output 

Compile output 

Source output 

Old prograna library 

New program library 

Merge 
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UPDTSCR 
UPDTCDK 
UPDTTPL 
UPDTEXT 
UPDTAUD 
UPDTPMD 

SELECTIVE COMPILE DIRECTIVE 

COMPILE (C) 




UPDATE scratch files 




Identifies decks to be 
written on compile file 



COMPILE FILE DIRECTIVES 

WEOR (W) Write end-of-record of 

specified level on com- 
pile file 

CWEOR (CW) Write end-of-record or 

end-of-file on compile file 
if the buffer is not empty 

CALL (CA) Write called common deck 

onto compile file 

IF Write text onto compile file 

if condition is defined 

END IF (EI) Optionally used to specify 

end- of- conditional text 

TEXT (T) The text following is not to 

be scanned for directives 

ENDTEXT (ET) Resume scan for directives 

DONT (DT) Do not rescind yanks of 

correction set applying to 
the following text 

DO Rescind yanks of correction 

sets applying to the follow- 
ing text 

To be recognized while the compile file is being 
written, these directives must have the same master 
control character as that defined when the library 
was created. 
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SPECIAL DIRECTIVES 



NOABBREV 


(NA) 


ABBREV 




LIMIT 


(LT) 


NOLIST 


(NL) 


LIST 


(L) 


DEFINE 


(DF) 


PULLMOD 


(PM) 


DECLARE 


(DC) 



List Comment 

Deselects the abbreviated 
directives feature 

Res elects the abbreviated 
directives feature 

Changes maximum size 
allowed for list output file 

Inhibits list output 

Resumes list output 

Defines names for sub- 
sequent use by IF direc- 
tives 

Recreates correction sets 

Restrict corrections to 
declared deck 



ALPHABETIZED LIST OF DIRECTIVES 

In the following, c indicates a card identifier of the 
form ident. seqnum. 



^ABBREV 



Check for abbreviated forms of 
directives. 



X. 



:=ADDF1LE file,c 
AF 



Read new decks and/or common 
decks from named file and insert 
the information after specified 
card (c). If c is omitted, decks 
are added at end of library. If file 
is omitted, the primary input file 
is used. 



-ADDFILE file, dname 

::cAF 

Read new decks and/or coinmon 
decks from named file and insert 
the information after specified 
deck (dname). If dname is omitted, 
decks are added at end of library. 
If file is omitted, the primary input 
file is used. 
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X-BEFORE c 



/'-■''CALL dname 
-CA 



Insert text following this directive 
into library before card specified 
by c. 

Causes text of common deck 
(dname) to be written on compile 
file. 




^'-CHANGE idname^,idname , . . . , idname^_ ^, idname^ 

i *CH 

I Changes correction set nanned 

idname. to idname. -.. idnanae is 
1-9 of tne following alphanumeric 




characters: 

A-Z 0-9 + 



/ ( ) $ = 



-'COMDECK dname, NOPROP 

Introduces common deck, dname 
is 1-9 of the following characters: 
A-Z 0-9 + - =:^ / ( ) $ = 

Presence of NOPROP specifies 
that if this deck is modified, decks 
calling this deck are not to be con- 
sidered modified. 




-COMPILE dname , . . . , dname 



When F and Q are not selected, 
identifies decks to be written on 
conapile file, new library, and 
source file. 



-COMPILE dname .dname. 



When F and Q are not selected, 
identifies range of decks (dname 
through dname ) to be written on 
new program library, compile file, 
and source file. 




-COPY dname, c This form, used during insertion, 
=;=CY reads card c frona named deck and 

inserts it. 




-COPY dname, c , c. 



-CY 



10 



This form, used during insertion, 
reads cards c through c and in- 
serts thena. 
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'COPY dname, c , c, , file 
CY ^ ^ 



•#- 



^:CWEOR level 



This form of COPY is not restric- 
ted to insertion. It is not' a correc- 
tion directive. This directive 
copies cards c through c, fronn 
the named deck (dname) onto the 
named file. 

Conditionally writes end of record 
(section) or end of file (partition). 
For NOS 1. and NOS/BE 1. 0, if 
level is 0-14, decimal, UPDATE 
writes an end of record of the 
specified level. For SCOPE 2, if 
level is 0-14 UPDATE writes an 
end of section. If level is 15 or 
greater UPDATE writes an end of 
file (end of partition for SCOPE 2). 



,/^:=DECK dname 
'DK 



Introduces new source deck of the 
specified name. Name is 1-9 of 
the following characters: 
A-Z 0-9 + - ^:W ( ) $ = 



^:^DECLARE dname 

=:=DC 

Protects decks other than the 
named deck from being inadver- 
tently altered. The restriction 
remains in effect until next 
DECLARE directive. Omitting 
dname nullifies a previous 
DECLARE. 



-'^DEFINE name^ , . . . , nanne 



=:^DELETE c 



Defines names for use by IF. 

Deletes specified card and option- 
ally inserts text following. 



'^:'DELETE c , c^ Deletes cards 

a D 
'■'D optionally inser 



c through c. 
rfs text follow; 



and 
owing. 



#• 
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-DO idname 



1" 



. , idname 



n 



Temporarily rescinds YANK and 
SELYANK for named correction 
sets. 




^:=DONT idname 
■■■DT 



r^^-END 



=ENDIF 
=EI 



^ENDTEXT 
--ET 



,,..., idname 
1 n 

Does not rescind YANK and 

SELYANK for namied correction 

sets. 

Provided for compatibility with 
SCOPE EDITSYM program; 
ignored by UPDATE 

Used to indicate end of conditional 
text when num parameter is 
onaitted from IF directive. 

Indicates end of sequence of text 
cards that begin with TEXT 
directive. 





^IDENT idname, p^,p,p. 
=ID ^ "^ 



'P. 



Identifies new correction set and 
optionally specifies bias for 
sequence numbers and /or condi- 
tions for including correction set. 
idname is 1-9 of the following 
characters: 

A-Z 0-9 + - ^:= / ( ) $ = 

p. are any number of the following: 

B = num Bias added to 

sequence numbers. 

K = ident Specifies ident re- 
quired before this 
set can be incorpora- 
ted. 

U^ident Specifies ident that 
must not be known if 
this set is to be 
incorporated. 






12 
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■IF type, name, num. 



•IF -type, n ami e, num 

Conditionally writes text. Type 
indicates type of name. Minus 
sign preceding type indicates nanne 
nnust not be known, num. if in- 
cluded, specifies nunaber of lines; 
otherwise, IF is terminated by 
ENDIF. 



^INSERT c 
=1 



Type 

DECK 

IDENT 

DEF 



Name 

Name is a deck name. 

Name is a correction 
set identifier. 

Nanae is defined 
through DEFINE 
directive. 



Inserts cards following this 
directive after the specified card 
(c). 



^LIMIT n 
=LT 



Sets new line liinit (decimal) for 
list output. 



^LIST 



Re-enables list option 4 previously 
disabled through NOLIST. 



'=MOVE dname.. , dname 



--;^M 



^NOABBREV 

^NA 



=NOLIST 

^NL 



p 



Moves dname. from its position on 
the old program library to after 
dname^ on the new prograna li- 
brary. 

Turns off the check for abbreviated 
forms of directives. When 
NOABBREV is in effect, abbre- 
viated nanaes for directives are 
recognized as text. 

Disables list option 4, the list of 
cards in the input stream. The 
option is disabled until a LIST 
directive is encountered. 
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-PULLMOD idname- , . . . , idnanie 



Recreates named correction sets. 




-PURDECK dname^ , . . . , dname 

^;-'PU ^ 



Purges all cards in named decks 
permanently. 



-PURDECK dname .dname, 



Purges all cards in decks dname 
through dname permanently. 



-PURGE idname, , . . . , idname 
-p 1 n 



Purges named correction sets 
permanently. 





-■'PURGE idname .idname, 
-p a b 



Purges correction sets idname 
through idname, pernnanently. ' 



*PURGE idname, 
--::p 



=:^READ file 



Purges correction sets idname and 
all correction sets introduced after 
it. 

Temporarily stops reading input 
file and reads insertion text and 
directives from specified file 
starting at its current position 
until an end of record. | 



-RESTORE c 
-R 



Reactivates previously deleted 
card (c). 



RESTORE c ,c, 
R ^ ^ 



-REWIND file 
^^'RW 



Reactivates previously deleted 

cards in range c through c, . 
'=' a ^ b 

Rewinds named file. 




-SELPURGE dname^ . idname. , . . . , dnanae . idname 
:^P 11 n n 



Causes purging of all cards in a 
specified deck dname belonging to 
a specified correction set idnanne. 



tEnd of section for SCOPE 2. 
14 
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-SELYANK dname . idnamo , . . . , dname . idname 

Causes yanking of all cards in a 
specified deck dname belonging to 
a specified correction set idname. 



-SEQUENCE dname^, . . . , dname 

Resequences named decks and 
purges inactive cards froni them. 



f/^^SEQUENCE dname .dname 



=:^S 



^^^SKIP file 
/^:^SKIP file TtT 

At EXT 



WE OR level 



Resequences decks dname through 
dname, and purges inactive cards 
from tnem. 

Skips 1 logical record -f forward on 
file. 

Skips n logical records f forward 
on file. 

The text following is not to be 
scanned for directives until an 
ENDTEXT is encountered. 

Writes end of record (section) or 
end of file (partition). For NOS 1. 
and NOS/BE 1.0, if level is 0-14 
decimal, UPDATE writes an end of 
record of the specified level. For 
SCOPE 2, if level is 0-14, UPDATE 
writes end of section. If level is 
15 or greater, UPDATE writes an 
end of file (end of partition for 
SCOPE 2). 



-YANK idname, , . . . , idname 
1 n 



Temporarily removes effects of 
nanaed correction sets. 



r^-YANK idnamie .idname, 
,.y a b 



Temporarily removes effects of 

correction sets idname through 

idname, . 
tL 



=:^YANKDECK dname, , . . . , dname 

1 n 

*YD ^ 



Tennporarily removes effects of 
named decks. 



/-/ comments Lists comments. 



tSection(s) for SCOPE 2. 
60450000 A 
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n 



"1 



MODES 
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NORMAL SELECTIVE MODE 



During a normal UPDATE run (F and Q are not 
selected on the UPDATE control card), UPDATE 
writes on the compile file all decks specified on 
COMPILE directives as well as all decks corrected 
during the run. COMPILE causes a deck to be 
written regardless of whether it was corrected or 
not. In normal mode, decks are written on the 
conapile file in the sequence encountered on the old 
program library. By selecting the K parameter on 
the UPDATE control card, the user causes decks to 
be written in the sequence specified on COMPILE 
directives followed by any decks for which correc- 
tions were made that were not mentioned on COM- 
PILE directives. 

FULL UPDATE MODE 

During a full update run (F selected on UPDATE 
control card), UPDATE ignores COMPILE directives. 
It updates all decks in the sequence encountered on 
the library. This sequence cannot be changed 
through the K option. 

QUICK MODE 

During a quick UPDATE run (Q selected), only decks 
specified on COMPILE directives and called common 
decks are written on the compile file. These decks 
are written in the sequence encountered on the pro- 
gram library unless the K option has been specified, 
in which case, they are written in the order specified 
on the COMPILE directives. 
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FILES 
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SOURCE DECKS AND FILES 

SOURCE DECKS PREPARED BY USER AS INPUT 
TO UPDATE 







SOURCE DECKS OPTIONALLY 
CONTAIN COMPILE FILE 
DIRECTIVES 



SOURCE FILE GENERATED BY UPDATE 



The source file contains a copy of all active DECK, 
COMDECK, TEXT, ENDTEXT, WEOR, CWEOR, CALL, 
IF, and ENDIF directives and all active cards within 
each deck. When T is selected on the UPDATE 
statement, conrimon decks are not written on the 
source file. The source file is optional output from 
UPDATE (through use of the S or T options on the 
UPDATE control card) and, once created, can be 
used as source input on subsequent UPDATE runs. 
The source file is a coded file that contains 80- 
column inaages. 






20 
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PROGRAM LIBRARY FILES 



RANDOM FORMAT 



<*■■ 




EACH DECK IS A 



t 



LOGICAL RECORD 



FIRST ENTRY POINTS 
TO YANK$$$ DECK 



SCOPE 2 Header"*" *" 



Random Index 



Rondom Index 



EOI--- 



t For SCOPE 2, each deck is a section 
t t Header applies to SCOPE 2 only 
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Under NOS/BE 1. 0, the random index record can be 
obtained by issuing an OPEN function on the file. 

Under SCOPE 2, however, to obtain random index, 
skip to EOI, backspace one record, and read. 




SCOPE 2 Random. Index Header 



59 



18 



00 



DIRECT $ 



n Number of words in random index; 

format is shown below 




Random Index Format 

The system generates two copies of the random index 
because a CLOSE causes the index to be written again, 




59 



48 



30 24 



18 



06 



00 



29-00 dllra Random address of 

first word of deck list 

1 59-48 none Unused 

1 47-30 dirl Length of directory in 

words 



WORD 


7000 


dll 


dllra 


1 




dirl 


dirra 


2 




X 


lab 


y 


c 


3 


label 


4 




Word 


Bits 


Field 


Description 





59-48 


7000 


Identifies random 
directory record 





47-30 


dll 


Lei 
in -^ 


igth C 
words 


>f the 

3 


deck 


list 
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Word Bits Field Description 

1 29-00 dirra Random address of 

first word of directory 

2 59-24 none Unused 

2 23-18 X IP- CSET character set 

identifier; 3=63 character 
set. 4 = 64 character set. 

2 17-12 lab Label flag; if nonzero, 

words 3 and 4 are pre- 
sent in random direc- 
tory and contain tape 
label. SCOPE 2 does not 
recognize tape labels. 



11-06 y 



05-00 c 



Type of programt 
library; must be Y or 
null to indicate 64- 
character set. 

Master control charac 
ter used when the 
program library was 
generated. 



Deck List Format 

The deck list contains a two-word entry for each 
deck on the library. The first entry points so the 
YANK$$$ deck. 



Each entry has the following fornaat: 

59 30 

WORD 

I 



06 



GO 



dname 




::::x::S::;:;:;:;:;xix;x^ 


ra 



■* 



Word 




Bits Field Description 

59-06 dname 1-9 alphanumeric 

character deck name 
obtained from DECK or 
COMDECK directive 
when deck was placed 
on library. The first 
dname is YANK$$$. 






05-00 


none 


Unused 


1 


59-30 


none 


Unused 


1 


29-00 


ra 


Random address of 
first word of com- 
pressed text for the 
deck. 
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Directory Format 

The directory is a table that contains one entry for 
each DECK, COMDECK and IDENT that has ever 
been used for this library. Directory entries each 
consist of one word containing the 1-9 character 
identifier in display code, left justified with zero 
fill. 



59 



06 



00 



ident 





For a purged ident, bits 59-06 are zeroed and bits 
05-00 contain a 20„. 



YANK$$$ Deck 

The YANK$$$ deck is automatically created on a 
creation run as the first deck on the program 
library. On correction runs, UPDATE inserts 
YANK, SELYANK, YANKDECK, and DEFINE 
directives into the YANK$$$ deck. These directives 
acquire identification and sequence information 
irom the correction set xrom wnicn tucy originats. 

The YANK$$$ deck cannot be yanked or purged. 
However, cards in the deck can be deleted, yanked 
or purged. 

Compressed Text Format 

Text is an indefinite number of words that contain a 
correction history and the compressed image of each 
card in the deck. Information for each card is in the 
following format: 




59 54 



36 



00 



chb 
flag 



i 


wc 


seqnum 


chb, 


chb2 


chb3 


chb 4 


• • • 


^-^=====^^^^^^ 


^^""^^^^^^^ 


"~~~ — ' 


• • • 


• • • 


COMPRESSED CARD 
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Bits 
59 



Field 
chb flag 



58 



57-54 none 
53-36 wc 

35-18 seqnum 



17-00 
and sub- 
sequent 
18-bit 
bytes 



chb 



De scription 

Indicates the last word containing 
correction history bytes. 

Not last Avord 

1 Last word 

Activity bit for the card. 

Card is inactive 

1 Card is active 

Unused 

Number of words of compressed 
text for this card. 

Sequence number of card (octal) 
according to position in deck or 
correction set identified by chb . 

Correction history byte. UPDATE 
creates a byte for each correc- 
tion set that changes the status of 
the card. The format of chb. is: 



17 



y a 



00 



ident no 



y 



identno 



Yank bit 

Card not yanked 

1 Card has been 
yanked 

Activity bit 

Correction set 
deactivated the card 

1 Correction set 
activated the card 

Index to the entry in the 
directory that contains 
the name of the correc- 
tion set or deck that 
introduced the card or 
changed the card status. 
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Compressed card 



The compressed imiage 
of the card in display- 
code. Single and 
double spaces are un- 
altered. Three or 
miore embedded spaces 
are replaced in the 
image as follows: 

3 spaces replaced by 
0002 

4 spaces replaced by 
0003 

5 spaces replaced by 
0004 



64 spaces replaced by 
0077g 

65 spaces replaced by 
007755 

66 spaces replaced by 
00775555 

67 spaces replaced by 

00770002^, etc. 
o 

When a space is the 

first character of a line, 

it is always represented 

as 55 o even when it is 

part of a string of 

spaces. 

Trailing spaces are not 
considered as embedded 
and are not included in 
the card image. A 4- 
digit octal code 0000 or 
word count (wc) reached 
marks the end of the 
card. This is condi- 
tional on the CHAR64 
option. 

When the full-character 
set installation option 
is assembled, a byte of 
0001 represents a colon. 
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NEW SEQUENTIAL FORMAT 



-'"** '^^ 



36 30 24 18 12 6 00 



WORD I 
WORD 2 




FIRST CARD OF A USER 
DECK IS A DECK OR H 
COMDECK DIRECTIVE 



DIRECTORY 



DECK LIST 



TEXT STREAM 



Checksum 



YANK$$$ DECK 



USER DECK, 



USER DECK2 



USER DECK. 



-COUNT OF BITS IN 
PROGRAM LIBRARY 



End -Of- Record t 
t l-:nd ol" section if record type is \V. l':ach W record is 512 words. 
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Word One 



59 



30 24 



06 00 



CHECK 



00 



lab 




Bits 



Field Description 






29-24 
23-18 

17-12 
11-06 



none 

X 

lab 



y 



05-00 



Identifies the file as being a new 
format sequential file. This field 
contains the word CHECK in dis- 
play code. 

Unused; zero 

IP-CSET character set identifier; 
3 = 63 character set, 4 = 64 charac- 
ter set. 

Presence of L indicates labeled 
tape. Null indicates unlabeled 
tape. SCOPE -2 does not recog- 
nize tape labels. 

Indicates whether or not this 
library was generated using full 
64-character set. 

Y Yes; colon is supported 
00 No; colon is not supported 

Indicates master control 
character in use when this library 
was created. 

First character of direc- 
tives is asterisk, the 
conventional master con- 
trol character. 

Other First character of direc- 
tives is character indi- 
cated. On a correction 
run, if the master control 
character specified on the 
UPDATE card does not 
match this character, 
UPDATE changes the 
character to c. On a 
merge run, if the control 
characters for the two 
libraries do not match, 
the run is aborted. 






-i^t^ 
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Word Two 

The second word of the program library file is 
composed of two binary counts: the count of the 
identifiers in the directory, and the count of the deck 
names in the deck list. 



59 



36 



18 



00 



ident count 



dname count 



Directory Format 

Entries in the directory are in the same format as 
for a random library. 

Deck List Format 

The deck list is a table consisting of one entry for 
each deck on the program library. Each entry con- 
sists of one word containing the deck name in display 
code, left justified, with zero fill. Decks are listed 
in the order in which they were introduced on the 
library. 

Text Stream 



The text stream immediately follows the deck list. 
Compressed text up to the first DECK or COMDECK 
directive comprises the YANK$$$ deck. Each 
subsequent deck begins with a DECK or COMDECK 
directive and consists of each card up to the next 
DECK or COMDECK directive or the end-of-record. 

Compressed Text Format 

Text on the sequential library is compressed in the 
same manner as on a random library. 
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OLD SEQUENTIAL FORMAT 

UPDATE optionally accepts old library files in the 
old (pre-SCOPE 3. 3) UPDATE sequential format. 
These libraries resemble the new sequential format 
but do not contain the CHECK word or checksum and 
the text format and chb's are different. Word two on 
the new format is the SEime as word one on the old 
format. UPDATE does not generate this obsolete 
sequential format. 





WORD 



FIRST CARD OF USER 
DECK IS DECK OR 
COMDECK DIRECTIVE 



y%^/. 


W^, 


idname 
count 


dnome 
count 


DIRECTORY 


DECK LIST 




TEXT 




STREAM 













' 






YANK$$$ DECK 



J> USER 



DECK, 



USER DECK2 



■USER DECKp 



End-of-Record 
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COMPILE FILE 



•Expanded Format 



'W 



The expanded compile file format for each card 
consists of 72 or 80 columns of data followed by to 
18 columns of sequence information. The maximum 
size of a card image is 90 columns. 

Expanded card image: 



^ 



72 OR 80 COLUMNS OF DATA 

r\ 



TO 18 COLUMNS OF 
SEQUENCING INFORMATION 

f\ . 



■\/ 



Data 



ident/seq. no. 



80- or 90- Column Card Image 



If the 80 (90) character card image on the compile 
file has two blanks as the last two characters, these 
are converted to a 0000 line terminator and the card 
image is 8 (or 9) words long. 

If the last two columns do not contain blanks, a word 
containing 8 blanks and a zero byte line terminator 
are added, thus making the card image 9 (or 10) 
words long. This same procedure is used for 
creation of the source file. 

Compressed Format 



59 54 48 42 36 




77 



00 



00 



00 



m/////////////m///// ////////m 



sequence field 



sequence field, 



compressed card. 




nw: 




nw, 
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sequence field 



17 characters comprising 
card columns 74-90. 
Columm 73 is always blank. 



nw. 

1 



compressed card. 



Binary number of words in 
compressed card.. 

Columns 1-72 of a COM- 
PASS source card in 
compressed form. That is, 
each 00 character is 
replaced by the 12 -bit value 
0001, and three or more 
consecutive blanks (to a 
maximum of 64) are 
replaced by a 12-bit value 
0002 through 0077 . A 
single blank is represented 
in display code (55^); two 
consecutive blanks "are 
represented by the 12 -bit 
value 5555 . If the last 
word is not full, it is padded 
on the right with binary 
zeros. Because word count 
nw. is present, an extra all- 
zei^o word is not required to 
guarantee 12 zero bits. 
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UPDATE STATEMENT 



60450000 A 



/update (pi,P2»- . • >Pn^ 



p. option 



option =f il en am e 

option=0 (valid for nnodes C and L only) 



Option 



Significance 



A - Sequential-to-random copy 
omitted No special mode 



A 



When this nnode is selected 
UPDATE copies a sequential old 
program library to a random new 
program library. It performs no 
other UPDATE "operations. The 
only other control card options 
that can be used, other than those 
specifying files, are -■'^ and /. For 
SCOPE 2, the new program library 
cannot be blocked. 






B 



- Random-to-sequential copy 
omitted No special mode 



B 



When this mode' is selected, 
UPDATE copies a randona old 
program library to a sequential 
new program library. It performs 
no other UPDATE operations. 
The only other control card 
options that can be used, other 
than those specifying files, are 
'■'■'■ and /. 



C - Comipile file output 



onnitted or C 



C=filename 



Compile output decks will be 
written on file COMPILE; 
contents are determined by 
type of UPDATE (F,Q, or 
normal). 

UPDATE writes compile 
output decks on named file; 
contents are determined by 
type of UPDATE (F, Q, or 
normal). 




• 
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r -^ 



Option Significance 

C = PUNCH This is a special form of 

C=filename. UPDATE writes 
compile output decks on 
PUNCH file. Decks are 
punched according to type of 
UPDATE (F, Q, or normal). 
This option also causes the 
8 and D modes to be selected. 

C = No compile output 

D - Data width 

omitted Compile output has 72 

columns for data 

D Compile output has 80 

columns for data 

E - Edit; provides a means of cleaning up old 
program libraries 

omitted The old program library is 

not edited. 

E UPDATE rearranges the 

directory to reflect the actual 
order of decks on the pro- 
gram library. 

During editing, UPDATE 
purges any cards other than 
YANK, SELYANK, and 
YANKDECK from the 
YANK$$$ deck. 

F - Full update 

omitted F and Q omitted is the 

normal (selective) UPDATE 
mode. All regular decks 
and common decks are 
processed. 

F Source and compile files, if 

specified, contain all active 
decks in old program library 
sequence. The contents of 
the new program library are 
the same as if F were not 
specified. 
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Option 



Significance 




G - Generate separate PULLMOD output file 

omitted Output from PULLMOD cards 

is appended to source file 
defined by S or T option or to 
the SOURCE file. 

G=filename Output from PULLMOD cards 
is written on named file. Any 
rewind option applying to the 
source file also applies to 
this file. 

H - Header change 

omitted or H Character set indicated in 

old program library header. 

63-character set. 

64-character set. 





H=3 
H=4 
I - Input 

omitted or I 
I^filename 



Input is on job INPUT file . 

Input comprises next record 
on named file . 



K - COMPILE card sequence (takes precedence 
over C mode) 



omitted 
K 

K=filename 

L - List options 
omitted 



12 n 



Output determined by C option. 

Compile output decks to be 
written on file COMPILE in 
COMPILE directive sequence. 

Compile output decks to be 
written on named file in 
COMPILE directive sequence. 



List options A, 1, and 2 are 
automatically selected on a 
creation run. Options A, 1, 
2, 3, and 4 are automatically 
selected on a correction run. 
Options Al are selected for A 
or B mode. 

Each character in string 
selects an option. 
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Option 
L (cont'd) 



Significance 



Option Significance 



A 



Listing of DECK 
names, IDENT 
names, COMDECK 

directives, decks 
on compile file and 
known definitions 

All selections other 
than 

No listing; zero in 
a string is equiv- 
alent to L=0 

Cards in error and 
associated error 

messages 

Directives 

Cards that changed 
status 

Input stream 

All active compile 
file directives 

Number of active 
and inactive cards 
by deck name and 
correction set 
identifier 

All active cards 
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Option Significance 

8 All inactive cards 

9 Correction history 
of all cards listed 
as a result of list 
options 5, 7, and 8. 

M - Merge output; allows two program, libraries 
to be merged and written onto the new pro- 
gram library (see N option). 

omitted No merge file 

M Second old program library 

on file MERGE 

M^filename Second old program library 

on named file 

N - New program library output 

For SCOPE 2, the library is random if the file 
specified for N is record type W and the UPDATE W 
option is not specified; the new program library can- 
not be a blocked file when performing an UPDATE (A). 
Under NOS 1, and NOS/BE 1. 0, the new program 
library is written in random format if the file specified 
by the N option is on mass storage and. the W option 
is not specified. It is written in sequential format if 
the file specified by N is not on mass storage (i. e. , on 
magnetic tape or card punch) or if the W option is 
explicitly specified. 

N New program library to be 

written on file NEWPL . 

N^filename New program library to be 

written on named file. 

omitted UPDATE does not generate 

a new program library. 

O - List output file 

omitted or O List output is written on job 
OUTPUT fHe. This file is 
automatically printed. 

0=filename List output is written on 

named file . 









38 60450000 A 



Option Significance 

P - Old program library; ignored on creation 
run. 

onnitted or P Old program library on file 
OLD PL 

P=filename Old program library on 

named file 

Q - Quick update (takes precedence over F) 

omiitted F and Q omitted is the 

normal (selective) UPDATE 
mode. See F omitted. 

Q Only decks specified on 

COMPILE directives and 
decks added through ADD- 
FILE directives are 
processed. 

R - Rewind files 

omitted The old and new program 

libraries, the compile file, 
and the source file are re- 
wound before and after the 
UPDATE runo 

R No rewinds are issued for 

the program libraries, 
compile file, or source filec 

R = c c^o . . c Each character in string 

^^ indicates a file to be re- 
wound before and after the 
UPDATE run. 

c_ File 

C Compile 

N New^ program library 

P Old program library 
and merge library 

S Source and PULLMOD 



S - Source output; the contents of the source file 
are determined by the mode in which UP- 
DATE is operating, the decks named on 
COMPILE directives, and the type of old 
program library in use (random or sequen- 
tial). 

1. If Q is not selected (regardless of F), 
the source file contains all cards re- 
quired to recreate the library. This 
recreated library is resequenced. 
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Option 



Significance 



2. If Q is selected and the old prograna 
library is sequential, decks written on 
the source file are those named on 
COMPILE directives and common decks 
they call. 

If Q is selected and the old program 
library is random, decks written on the 
source file are those named on COM- 
PILE directives. 





omitted 



T 



UPDATE does not generate 
a source output file unless 
the source output is speci- 
fied by T. 

Source output written on file 
SOURCE 

Source output written on 
named file. 

Source output excluding common decks (takes 
precedence over S) 




S=filename 



omitted 



T 



T=filenam.e 

U - Debug mode 
omitted 

U 



No source output unless 
source output specified by S. 

Source output excluding 
comm.on decks on file 
SOURCE. 

Source output excluding 
common decks on nanaed 
file. 



UPDATE execution ternain- 
ates upon encountering a 
fatal error. 

UPDATE execution is not 
termiinated by normally 
fatal errors. 



W - Sequential new program library 

omitted The new program library 

(see N option) will be 
determined by charac- 
teristics of file specified 

by N. 




W 



The new program library 
(see N option) will be a 
sequential file. 



• 
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Option Significance 

X - Compressed compile file 

omitted Connpile file is not in com- 

pressed format. 

X Compile file is in com- 

pressed format. 

Z - Compressed input file 

omitted The input file (see I option) 

is a normal, coded file, 

Z The input file (see I option) 

is assumed to be in PCS 
compressed format. This 
parameter applies to the 
directives input file only; 
it does not apply to files 
specified by READ direc- 
tives. 

8 - 80-column output on conapile file 

onnitted Compile file output is com- 

posed of 90- column card 
images. 

8 Conapile file output is com- 

posed of SO-columm card 
images. 

''' - Master control character 

omitted The master control charac- 

ter is '■'. 

"'=char char can be any character 

having a display code octal 
value in the range 01-54 
except for 51 and 52 (the 
open and close parentheses). 

/ - Conament control character 

omitted The comment control 

character is /. 

/=char char can be A through Z, 

through 9 or + - - / $ = 



60450000 A 41 



